home *** CD-ROM | disk | FTP | other *** search
/ Palm Utilities / Palm_Utilities_CD-ROM_2001_2001.iso / files / shell misc / Pilot Explorer 1.5 / expl-sw.exe / readme.txt < prev    next >
Encoding:
Text File  |  1998-06-10  |  10.6 KB  |  257 lines
  1.                      P I L O T   E X P L O R E R
  2.                      ===========================
  3.  
  4. Author:  Scott Powell (of Evolutionary Systems)
  5. Email:   support@evolutionary.net
  6. Version: 1.5
  7. Date:    09/06/1998
  8.  
  9. Copyright Notice
  10. ================
  11.  
  12.    Copyright(c) 1997, Evolutionary Systems.
  13.  
  14.  
  15. Install Notes
  16. =============
  17.  
  18.   Simply use 'instapp' to install the 'explorer.prc' & 'pimapps.prc' files
  19.   onto your pilot. There should also be other .PRC files. These are standard
  20.   'Plugins' (see below), which are optional add-ons which you can install if
  21.   you like (using 'instapp').
  22.  
  23.  
  24. Instructions
  25. ============
  26.  
  27.   Explorer gives you a 'tree view' of your data. If you have used any
  28.   modern Graphical User Interface (GUI's) you will probably have seen
  29.   a 'tree' view like this. Basically objects are represented in a hierarchy,
  30.   shown by indentation, ie. objects owned by another are shown underneath
  31.   their 'parent' and indented (to the right).
  32.  
  33.   Each object is displayed in the following format:
  34.  
  35.     [ICON]  [Tree text]  | [Size/other-info Text]
  36.  
  37.   The icon will show what type of object it is (ie. Memo, Address, etc.)
  38.   and the 'Tree text' is some identify text of the object. The text to the
  39.   right varies depending on the type of object. For group objects it is
  40.   usually the number of child objects it owns.
  41.  
  42.   Objects that hold 'child' objects are termed as 'group' objects. These
  43.   can have a '+' or '-' displayed inside their icon which indicates whether
  44.   they can be 'expanded' or 'collapsed'.
  45.  
  46.   If you tap on the 'Tree text' part of the object, or on the 'size' text,
  47.   then the default action is performed on that object. These are:
  48.  
  49.        for group objects     - 'toggles' branch, ie. expands or collapses
  50.        for non-group objects - launches 'viewer' for object.
  51.  
  52.   If you tap on the icon of the object you get its 'context menu'. These
  53.   have the full list of actions you can perform on the object.
  54.  
  55.   At the top right corner of the screen are three radio buttons, for
  56.   controlling the current 'mode' of operation. These are explained below:
  57.  
  58.         Select      - Normal mode, where you can expand/collapse branches,
  59.                       and select object's context menus.
  60.  
  61.         <->         - select this mode when you wish to move the vertical
  62.                       bar left and right. Once in this mode, just drag the
  63.                       pen on the screen to move the bar.
  64.  
  65.         Scroll      - when in this mode, the pen being held down will cause
  66.                       the tree to scroll up (if the pen is in the upper half
  67.                       of the screen), or down (if the pen is in the lower
  68.                       half)
  69.  
  70.   Graffiti Key Strokes:
  71.  
  72.     * Backspace - If you type this the current (highlighted) object becomes
  73.                   the PARENT of the current object. This is very handy for
  74.                   collapsing the current branch you are on.
  75.  
  76.     * <Alpha>   - If you type an alphabetic character, the current object
  77.                   becomes the FIRST CHILD object that starts with that
  78.                   letter. Very handy quick search (esp. in the address book)
  79.  
  80.   Hardware Buttons:
  81.  
  82.     * Up & Down - These buttons scroll the tree up and down. (like in 'Scroll'
  83.                   Mode)
  84.                   NOTE: These buttons may do different things when a dialog box is
  85.                         currently being displayed. Some of these are:
  86.  
  87.                        Find Dialog:   Scrolls the hit-list up and down.
  88.                        Address View:  Flicks between the top & bottom page of the
  89.                                       address details.
  90.                        Memo View:     Scrolls the memo text up and down.
  91.  
  92.   At the bottom of the screen is the 'status line'. This is a multi-purpose
  93.   area for helpful information, or short-cuts to your favourite commands.
  94.   See below for more about the status bar.
  95.  
  96.  
  97. Plugins & Status Bar!!
  98. ======================
  99.  
  100.   Explorer now supports 'Plugins'. These are add-on modules which provide
  101.   access to 3rd party databases, and/or provide helpful status-bar displays (see
  102.   below). Please contact the author of your favourate apps for them to provide
  103.   a Plugin for their data. Plugins can optionally have support for Folders!
  104.   If the Plugin provides this, then you can create/move/edit/delete objects of
  105.   its types inside Folders!
  106.  
  107.   Three standard Plugins are provided (along with source code, for interested
  108.   developers). These are 'Clock-Plugin', 'Battery-Plugin' and 'Trash-Can
  109.   Plugin'. These are examples of what can be done with the status line. They
  110.   aren't, however, examples of 3rd party database access. If there isn't enough
  111.   room on the screen for all the 'applets' then scroll arrows come up, letting
  112.   you scroll the status bar left & right.
  113.  
  114.   NOTE:   Access to the PIM objects (Memo, Address, Datebook & ToDo) is now
  115.           provided through a Plugin called 'PIM-Apps' (pimapps.prc).
  116.  
  117.   The status bar is completely 'open ended', and there are many possibilities
  118.   for 'applets' to put there. If you have something you would dearly love to
  119.   have on the status bar contact me and I'll consider writing a Plugin, or
  120.   have a go at writing one yourself by using the source code of one of the
  121.   samples.
  122.  
  123.  
  124. Folders!!
  125. =========
  126.  
  127.   The last object under the 'root' object ('Pilot Desktop') is the root
  128.   branch of the 'Folders' area. This is a new concept to Pilots. Here you
  129.   can create your own Folders (or directories, if you like) using the 'New...'
  130.   action in the context menu. Here, you can have any number of sub-folders,
  131.   and folders in folders. You can also create, move or copy any PIM object
  132.   (Memo, To Do, etc.) here.
  133.  
  134.   Have a play with them, I'm sure you'll find them very useful.
  135.  
  136. NOTE:  not all of the above features are completed yet, but will be very soon.
  137.  
  138. NOTE:  For standard PIM objects, they are still stored under the usual
  139.        application's databases, but are put in an 'unused' category. See
  140.        below for more on this topic.
  141.  
  142.  
  143. Standard PIM Objects (Memo's, To Do's, etc.)
  144. ====================
  145.  
  146.   For the 'Memo', 'Address' & 'To Do' application entries in the tree, you
  147.   can now select their 'view/edit' action. This pops up a dialog asking you
  148.   for your preferred 'unused' category for that application. As the PIM objects
  149.   can be moved to or created in a Folder they must be 'marked' as being in
  150.   a Folder (NOT a category). So, you must nominate ONE of your categories (in
  151.   each application) to be the 'unused' one.
  152.  
  153.   By default this category is the 'Unfiled' category (for all PIM apps). This
  154.   is why you may have noticed some of your records don't show up.
  155.  
  156.   Just select a category (must be empty) and Explorer will automatically update
  157.   all existing Folder objects of the application type you are modifying, to the
  158.   new 'unused' category, and mark all new and moved objects from that
  159.   application with this category.
  160.  
  161.   Select the Datebook's View/Edit action to pop-up it's configuration
  162.   dialog. Here you can select whether you want the appointments to be
  163.   displayed in ascending or descending order (ie. from oldest->newest,
  164.   or newest->oldest).
  165.  
  166.  
  167. Known Bugs
  168. ==========
  169.  
  170.   Various functions aren't implemented yet. You will see a dialog box when
  171.   you select such a function. Below is a list of known problems:
  172.  
  173.      - To Do details dialog doesn't show or update due date.
  174.      - Setting an appointment with an Alarm will not cause an alarm
  175.        to be issued. This will be implemented soon!
  176.      - Some users have noticed conflicts with the 'Hack Extensions'
  177.      - Low memory conditions can cause problems in redrawing.
  178.      - There is currently a limit of 512 elements on the size of the whole
  179.        tree. If this is reached a fatal error is issued. This will be improved
  180.        shortly, automatically collapsing branches that are not in use.
  181.  
  182.   If you discover new bugs please contact me by Email at:
  183.  
  184.       support@evolutionary.net
  185.  
  186.  
  187. Future Directions
  188. =================
  189.  
  190. * With the open-endedness of Plugins, there should be (hopefully) many
  191.   interesting and usefull extensions available in the near future.
  192.  
  193. * Backup/Restore of Folder database.
  194.  
  195.  
  196.  
  197. Revision History
  198. ================
  199.  
  200. 09/06/1998  1.5   - Shareware expiry taken out. Now just adds
  201.                     delay at start if not a registered user.
  202.  
  203. 04/08/1997  1.4   - Minor touch-ups:
  204.                      screen blank at startup in shareware version now fixed
  205.                      vertical separator goes all the way to the left sometimes,
  206.                           now puts it back to the right when this is detected.
  207.  
  208. 07/07/1997  1.3   - Added expiry reminder at start of program.
  209.  
  210. 23/06/1997  1.2   - Added 'History List', last 10 objects viewed,
  211.                       accessable from Status Bar icon.
  212.                     Moved PIM object access to a Plugin, pimapps.prc.
  213.                     Can now create and update Address & Datebook objects.
  214.                     Datebook now has configuration dialog (select it's
  215.                       View/Edit action). Can now view appointments in
  216.                       ascending or descending order.
  217.                     Improved dynamic heap usage, less memory being used.
  218.                     Wrote simple 'calculator' plugin.
  219.  
  220. 15/06/1997  1.2pr - Added comprehensive Plugin sample (for developers)
  221.                     Fixed Datebook date display error
  222.  
  223. 13/06/1997  1.1   - Added 'Select Unused Category' functionality (launched
  224.                         from PIM app's 'view/edit' action)
  225.                     Can now create To Do's  (from 'New..')
  226.                     Fixed problem when creating new PIM object, then updating
  227.                          (need for synchronization could be missed)
  228.                     Extra capabilities for status bar applets
  229.                           - can now capture pen input if they want
  230.                           - can handle 'drag & drop' events (TrashCan is
  231.                               example of this)
  232.                     Implemented scrolling of status bar.
  233.  
  234. 10/06/1997  1.0   - Commercial release
  235.                     Finished functionality of Folders (new/move/delete)
  236.                     Created 'Plugin' interface.
  237.                     Created status bar interface.
  238.                     Created Folder soft-type interface.
  239.  
  240. 03/06/1997  0.1b  - Initial version (beta)
  241.  
  242.  
  243. Credits
  244. =======
  245.  
  246.   thanks to:
  247.      - John J. Lehett        for the GNU 'C' port.
  248.      - Wes Cherry            for 'PILRC'
  249.  
  250.  
  251. Standard Disclaimer Stuff
  252. =========================
  253.  
  254.   This program is presented 'as is'. We take no responsibility in any loss of data
  255.   or productivity in case of operating failures.
  256.  
  257.